home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 72 / maccd 72.iso / macware / bb Folder / Read about Black & Bleu™ < prev    next >
Encoding:
Text File  |  2000-07-23  |  16.5 KB  |  289 lines  |  [TEXT/ttxt]

  1. Black & Bleu™  and Black & Bleu™/PRO
  2. Black & Bleu™  is an application that shows you the meaning of all of the documented and most of the undocumented Mac OS error codes. Many codes include information about what might be the cause of the error and what you can do about it.
  3.  
  4. The database contains over 4,300 error codes with Apple's short explanations of each. Our detailed explanations and remedies are included for the most common of these errors. The type of detailed information can be selected from 2 categories: a Non-technical User orientation and a Programmer orientation. The Non-technical User explanation is presented in a way that someone without a programming background can understand. The Programmer explanation is written in VERY technical terms that usually includes source code that demonstrates the error. To fully understand the Programmer explanation, you should be familiar with Macintosh programming (in C or C++).
  5.  
  6. The "PRO" form differs from the less expensive standard version in only one important way. The "PRO" version allows you to export the detailed explanations to a file. This feature allows Technical Professionals to pass the information on to others - something not permitted by the terms of the standard version. The software license reflects this ability as well.
  7.  
  8. This document describes Black & Bleu™  and Black & Bleu™/PRO  v2.1.
  9.  
  10. System Requirements
  11. • Mac OS 7.0 or later
  12. • Any Mac or clone
  13. • 6.9 MB of disk space
  14. • 1.8 MB of RAM
  15. • SimpleText  - any version (supplied by Apple)
  16. • A Screen resolution of 640 by 480 or larger set to at least 256 colors is recommended for reading the Instruction Manual.
  17.  
  18. Availability
  19. Black & Bleu™  is available from our web site:
  20.      www.bleurose.com
  21. as a free fully functioning demo.  This demo can be launched for a total of 3 times before it expires. Otherwise it is an exact copy of the commercial version. In fact, if you purchase the license key and apply it to your demo copy, the demo is converted directly into the commercial version. No additional downloads are required.
  22.  
  23. Black & Bleu™/PRO  is included with the files that come with Black & Bleu™. This is a fully functional demo except as follows. The demo only shows you how the "Export" of explanations works. It doesn't actually allow you to export the explanation text. Once you purchase the product, your license key will enable full export capabilities automatically.
  24.  
  25. Download size
  26. 1.6 MB   (about 5 minutes at 56k)
  27.  
  28. Price
  29. If you order via the Web using Kagi's Online Store (www.kagi.com/?QZX), the prices are as follows:
  30. $29.00 USD (Standard electronic version)
  31. $41.00 USD  (Standard CDROM version)
  32.  
  33. If you don't use the online store the prices are:
  34. $34.00 USD (Standard electronic version)
  35. $46.00 USD  (Standard CDROM version)
  36.  
  37. Pricing for the PRO version (regardless of the way you order) is:
  38. $129.00 USD (PRO electronic version)
  39. $141.00 USD  (PRO CDROM version)
  40.  
  41. Free upgrades will be provided to customers who purchased Black & Bleu™ within 45 days of the official release date of a new version. The official release date is established by the date specified in the Press Release announcing the version (available on our web site). You will receive your new License Key automatically if you qualify. You don't need to contact us for it.
  42.  
  43. If you don't qualify for the free upgrade offer, the upgrade prices are as follows.
  44. Via the Web using Kagi's Online Store (www.kagi.com/?QZX1):
  45. $19.00 USD (Standard electronic version)
  46. $31.00 USD  (Standard CDROM version)
  47.  
  48. If you don't use the online store upgrade prices are:
  49. $20.00 USD (Standard electronic version)
  50. $32.00 USD  (Standard CDROM version)
  51.  
  52. Since this is the first release of the PRO version, there is no upgrade pricing available for it.
  53.  
  54. Upgrades are made available to previous customers only. If you don't own a copy of Black & Bleu™  already, you are not eligible for upgrade pricing. Upgrade pricing applies regardless of the version of Black & Bleu™  that you originally purchased.
  55.  
  56. Free License offer 
  57. If you  write a detailed explanation for an error that doesn't have a detailed explanation already you will be entitled to a free License.
  58.  
  59. You must do the following:
  60. 1) Write an explanation for an error that doesn't have an explanation in our current version (v2.0).
  61. 2) Format the explanation in the style we use in Black & Bleu™  currently:
  62.         Summary
  63.  
  64.         Details
  65.  
  66.         What to do
  67.  
  68. 3) Focus on a non-technical user as you write your explanation. You may include a "Programmer's explanation" if you like but the Programmer's explanation is optional.
  69. 4) Send your explanation as an EMail to: explanation@bleurose.com
  70.  
  71. We will evaluate your submission for suitability. If it doesn't follow the "rules" (above) we will reject it.
  72.  
  73. If we accept it, we may modify it. We will then enter it into the database that will become part of the next release.
  74.  
  75. You will receive "Author Credit" for your explanation.
  76.  
  77. To determine if an error already has an explanation, launch the "Request an Error Analysis " application and enter the error number you are interested in explaining. When you click the "Save" button, the application will issue a warning to you if the error is already explained.
  78.  
  79. Restrictions
  80. All explanations are in English. The PRO demo produces only a template file for any explanations that you might try to export. The actual explanations are not exported.
  81.  
  82. Installation
  83. Black & Bleu™  is supplied as a self-extracting StuffIt archive file. The archive contains the following items:
  84.        Black & Bleu™                        - the error analyzer application
  85.        Black & Bleu™/PRO               - the error analyzer application (PRO version)
  86.        Read about Black & Bleu™   - a copy of the file you are now reading
  87.        B & B Instruction Manual      - an application containing information
  88.                                                            about using Black & Bleu™ 
  89.        Printable Instructions          - a folder containing the chapters of
  90.                                                             the instruction manual in SimpleText
  91.                                                             format. These files are black & white
  92.                                                             with spacing suitable for printed output.
  93.        Notes                                       - a folder containing a file that describes
  94.                                                             how to add notes to B&B's explanations
  95.        Request an Error Analysis  - an application you can use to ask us
  96.                                                           about error you've gotten.
  97.                                   (This is a FREE service offered by Bleu Rose Ltd.)
  98.        Read about Request...         - a file similar to the one you are reading
  99.                                                          describing Request an Error Analysis 
  100.        Prepare your Order            - an application that helps you pay for 
  101.                                                          Black & Bleu™  via FAX, EMail or
  102.                                                          traditional Mail.
  103.        How To Order                       - instructions for ordering using
  104.                                                           Prepare your Order . Prepare your Order 
  105.                                                           helps you order Black & Bleu™.
  106.       Your License Key                 - Information about the License Key
  107.                                                          that you need to turn the demo into
  108.                                                          the commercial version.
  109.        Disk Utility Shoot-out       - A comparison of various disk repair
  110.                                                          utilities by Misha Sakellaropoulo
  111.                                                          of the Macintosh News Network
  112.                                                          (www.macnn.com)
  113. (Applications are indicated by italics)
  114.  
  115. Purchasing Instructions
  116. Black & Bleu™ can be purchased:
  117. - using a credit card
  118. - using First Virtual
  119. - with Cash, Check or Purchase Order
  120.  
  121. We use Kagi as our "Order Desk" for all transactions except Purchase Orders. See the file "How to Order" for details on ordering using any payment method.
  122.  
  123. If you want to order by credit card via the Web go directly to Kagi's Web Site (http://orders.kagi.com/?QZX) using your web browser. You can also go to the Bleu Rose Ltd. Web Site (www.bleurose.com) and link to Kagi from there.
  124.  
  125. Otherwise, use the Prepare your Order   application (one of the files in the package you downloaded) to help you prepare your order. Full instructions for using Prepare your Order   are located in the "How To Order" file.
  126.  
  127. Credit cards accepted:
  128. - American Express
  129. - Diners Club
  130. - Discover
  131. - Mastercard
  132. - Optima
  133. - VISA
  134.  
  135. and
  136.  
  137. - First Virtual
  138.  
  139. You can find detailed information about how to order in the file called "How To Order" (included in the collection of files you just installed).
  140.  
  141. Contact Information
  142. Bleu Rose Ltd.
  143. PO Box 5536
  144. Hacienda Heights, CA  91745-0536
  145. USA
  146. Voice Mail: +1 626-913-7996
  147. FAX:  +1 626-965-6241
  148. EMail: sales@bleurose.com
  149. WWW: www.bleurose.com
  150.  
  151. Kagi
  152. 1442-A Walnut St.  #392
  153. Berkeley, CA  94709-1405
  154. USA
  155. FAX: +1  510-652-6589
  156. EMail: kagi@kagi.com
  157. WWW: www.kagi.com
  158.  
  159. Version Numbers
  160. Our numbering scheme is important to you because you can tell if upgrading to the current version will be free or cost you more money.
  161.  
  162. NOTE: With this 2.0 release of Black & Bleu™  we have changed the way we use version numbers.
  163.  
  164. Here is how we use version numbers for Black & Bleu™. All of our version numbers are 2 digits separated by decimal points.
  165.  
  166. We use the last digit of the two digit version number to indicate a bug fix release. Bug fix releases are always free to anyone who purchased the version that has the same other digit.
  167.  
  168. As an example, say you bought v2.0 and we later released v2.1. The same access key you received for v2.0 would also unlock v2.1. That is because the first digit of the number is the same.
  169.  
  170. If we add new features to the product, we would then change the first version number. For example, let's say you originally bought V1.2. This 2.0 version would use a NEW access key that you would have to buy since the first digit of the version number would be 2 instead of 1. Note that if you purchased a version within 45 days of the formal release of the next version, you get the new version free. The formal release date is determined by a dated Press Release announcing the new version. A copy of the most recent Press Release will always be available on our web site www.bleurose.com.
  171.  
  172. We also append a letter to the end of the version number. This letter indicates where you obtained the product. For example, "w" means you got it from our web site. "c" means it came from our CDROM. "p" means it came from a press kit. And so forth. There are other letter designations that we use as well. If you take advantage of our free "Error Analysis" service, the version number (including the letter) is included in your query.
  173.  
  174. Pre-Release Software Policy
  175. Under NO circumstances do we release "Developer", "Beta", "Alpha" or any other form of pre-release quality software to the general marketplace. Unless you are one of our official beta testers, you will NEVER receive such software from us or find it on our website.
  176.  
  177. If you would like to be considered for a position as Beta Tester, EMail us expressing your interest and provide your qualifications. Address your message to: beta@bleurose.com.
  178.  
  179. Our Guarantee
  180. Unlike most other software vendors, we offer an unconditional guarantee on our products. If you are unhappy with any of our products for any reason within 45 days of your purchase, we will refund ALL your money - period.
  181.  
  182. Send EMail to refunds@bleurose.com if you wish to exercise this option.
  183.  
  184. Version History (PRO version)
  185. v2.1 - Released in July 2000 (new version numbering applies - see above)
  186.    Bugs fixed:
  187.            • Under certain conditions, if you tried to "View" an error from the
  188.               Numeric List window, your Mac would crash.
  189.            • Error 29 (kSCBadSerialNumErr) would not display properly.
  190.  
  191. v2.0 - Released in June 2000 (new version numbering applies - see above)
  192.            • This is the first version of this product
  193.  
  194. Version History (Standard version)
  195. v2.1 - Released in July 2000 (new version numbering applies - see above)
  196.    Bug fixed:
  197.            • Under certain conditions, if you tried to "View" an error from the
  198.               Numeric List window, your Mac would crash.
  199.            • Error 29 (kSCBadSerialNumErr) would not display properly.
  200.  
  201. v2.0 - Released in June 2000 (new version numbering applies - see above)
  202.      New Features
  203.            • Added 1,044 more error codes - for a total of 4,384 codes
  204.            • Added 22 more error categories (for a total of 154)
  205.            • Added more detailed explanations
  206.            • Added "Annotations" - the ability for you to add your own notes
  207.                to error code explanations
  208.            • Added a numeric listing of all error codes
  209.            • Added a way to enter error codes in hexadecimal
  210.            • Added a way to display our Terms & Conditions any time you like
  211.     Changes:
  212.            • The "Virtual Memory On" warning is no longer displayed if you are
  213.                using Mac OS 8.6 or above. Our testing indicates that Virtual Memory
  214.               no longer contributes significantly to the instability of the Mac OS in
  215.               these newer versions.
  216.            • Improved RAM utilization to speed up the process of switching
  217.               from one error list to another.
  218.            • Increased the memory footprint from 1.5 MB to 1.8 MB due
  219.                to increased list sizes
  220.     Minor bugs fixed:
  221.            • If you requested an error analysis for an error that wasn't
  222.               explained, sometimes you would get a warning that the error
  223.               WAS already explained.
  224.           • If you had an explanation visible and partially scrolled
  225.               down from the top and then selected another application
  226.                when you came back to B&B, the scroll bar would be set
  227.                to the same place but the text would be at the top again.
  228.  
  229. v1.2.1 - Released in March 2000
  230.      New Features
  231.           • None
  232.     Changes
  233.           • Added "Free License" offer
  234.     Minor bugs fixed
  235.           • None
  236.  
  237. v1.2 - Released in December 1999
  238.      New Features
  239.            • Added 358 more error codes - for a total of 3,340 codes
  240.            • Added many more detailed explanations
  241.            • Added Sad Mac error explanations
  242.            • Added a full database text search capability
  243.            • Added 26 more error categories (for a total of 132)
  244.            • Reduced the number of "unclassified" errors (from 93 to 14)
  245.            • All windows can now be collapsed via the Collapse Box
  246.            • The main window uses a colored background in the
  247.                explanation text area
  248.            • A bit of humor to lighten your day (see if you can find it)
  249.     Changes
  250.            • Support for Mac OS 9
  251.            • Instruction Manual format changed from PDF to
  252.               SimpleText and ManualMaker
  253.     Minor bugs fixed:
  254.            • If you changed error lists (via the "List" menu) sometimes
  255.               the multiple error codes popup menu would say there
  256.               were other errors when there weren't.
  257.            • The font that was used to display the NAME list would
  258.               change as the list was scrolled. This caused newly displayed
  259.               names to look slightly different than the other ones.
  260.  
  261. v1.1.1 - Released in July 1999
  262.            • Fixed a bug that would cause a Type 11 or Type 25 crash if
  263.               you tried to use the demo beyond its expiration count
  264.            • Fixed a problem caused by clicking the mouse in the
  265.               explanation text area of B & B's main window
  266.            • Relaxed the Virtual Memory warning
  267.  
  268. v1.1 - Released in June 1999
  269.            • Added 416 more error codes
  270.            • Added many more detailed explanations
  271.            • Enhanced all "User Oriented" detailed explanations
  272.               with additional information
  273.            • Added a way to distinguish between error codes
  274.               that use the same error number
  275.            • Added the name of the system component that
  276.                is associated with the error (such as QuickTime)
  277.            • Added a way of listing only those errors that are
  278.               associated with a specific system component
  279.  
  280. v1.0.1 - Released in March 1999
  281.            • Added support for the <Home>, <End>,
  282.               <Page Down> and <Page Up> keys
  283.            • Added support for CDROM packaging
  284.            • Replaced Aladdin Systems with Kagi
  285.               as our "Order Desk"
  286.  
  287. v1.0  - Released in December 1998
  288.  
  289. Rev. July 23, 2000